home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / mus / misc / ahiusr.readme < prev    next >
Encoding:
Text File  |  1997-09-05  |  9.4 KB  |  230 lines
  1. Short:    Retargetable audio v4.14, User's Archive
  2. Author:   Martin Blom <lcs@lysator.liu.se>
  3. Uploader: Martin Blom <lcs@lysator.liu.se>
  4. Type:     mus/misc
  5.  
  6.      This archive contains the binary distribution of AHI,
  7.      everything you need to use programs that require AHI,
  8.      and documentation in AmigaGuide® format.
  9.  
  10.      Changes since last release
  11.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  12.      Bug fixes.
  13.      The Paula driver can now be told to swap left and right channel.
  14.      Toccata driver updated, should work fine on Draco Motion again.
  15.      Added Melody to the distribution.
  16.  
  17.  
  18.  
  19. TITLE
  20.  
  21.      AHI Audio system
  22.  
  23. VERSION
  24.  
  25.      Release 4
  26.  
  27. AUTHOR
  28.  
  29.      Martin Blom <lcs@lysator.liu.se>
  30.  
  31. DESCRIPTION
  32.  
  33.      Retargetable Audio for AmigaOS
  34.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  35.  
  36.      (When refering to this software, the correct term is
  37.      'AHI audio system' or just 'AHI', never 'Audio Hardware
  38.      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  39.  
  40.      Starting with version 3 of AHI, the MC68000 processor is also supported.
  41.      However, many features are lacking:
  42.  
  43.      · Very limited volime control when using 16 bit samples
  44.      · No HiFi mixing routines are available.
  45.      · No stereo samples
  46.      · No DSP effects are available.
  47.      · Less precision on some calculations
  48.      · Slower
  49.  
  50.      As you can see, this version is very primitive.  Get yourself an
  51.      accelerator!  I cannot guarantee that I will continue to support this
  52.      processor in the future.
  53.  
  54.      Quick overview
  55.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  56.  
  57.      * Driver based
  58.  
  59.      Each supported sound card is controlled by a library-based audio
  60.      driver. For a 'dumb' sound card, a new driver should be written in
  61.      a few hours. For a 'smart' sound card, it is possible to utilize an
  62.      on-board DSP, for example, to maximize performance and sound quality.
  63.      For sound cards with own DSP but little or no memory, it is possible
  64.      to use the main CPU to mix channels and do the post-processing
  65.      with the DSP. Available today are drivers for
  66.  
  67.      · Aura (sampler only)
  68.      · Delfina DSP and Delfina Lite
  69.      · DraCo Motion
  70.      · Paula (8/14/14c bit)
  71.      · Prelude
  72.      · Toccata
  73.      · Wavetools
  74.      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  75.  
  76.      * Fast, powerful mixing routines (yeah, right... haha)
  77.  
  78.      The device's mixing routines mix 8- or 16-bit signed samples, both
  79.      mono and stereo, located in Fast-RAM and outputs 16-bit mono or stereo
  80.      (with stereo panning if desired) data, using any number of channels
  81.      (as long as 'any' means less than 128...).  Tables can be used speed
  82.      the mixing up (especially when using 8-bit samples).  The samples can
  83.      have any length (including odd) and can have any number of loops.
  84.      
  85.      * Support for non-realtime mixing
  86.  
  87.      By providing a timing feature, it is possible to create high-
  88.      quality output even if the processing power is lacking, by saving
  89.      the output to disk, for example as an IFF AIFF or 8SXV file.
  90.      There are so-called HiFi mixing routines that can be used, which
  91.      use linear interpolation and gives 32 bit output.
  92.  
  93.      * Audio database
  94.  
  95.      Uses ID codes, much like Screenmode IDs, to select the many
  96.      parameters that can be set. The functions to access the audio
  97.      database are not too different from those in 'graphics.library'.
  98.      The device also features a requester to get an ID code from the
  99.      user.
  100.  
  101.      * Both high- and low-level protocol
  102.  
  103.      By acting both like a device and a library, AHI gives the programmer
  104.      a choice between full control and simplicity. The device API allows
  105.      several programs to use the audio hardware at the same time, and
  106.      the AUDIO: dos-device driver makes playing and recording sound very
  107.      simple for both the programmer and user.
  108.  
  109.      * Future Compatible
  110.  
  111.      When AmigaOS gets device-independent audio worth it's name, it should
  112.      not be too difficult to write a driver for AHI, allowing applications
  113.      using 'ahi.device' to automatically use the new OS interface. At
  114.      least I hope it wont.
  115.  
  116. SPECIAL REQUIREMENTS
  117.  
  118.      AmigaOS release 2.
  119.      MC68020 processor strongly recommended.
  120.  
  121. AVAILABILITY
  122.  
  123.      Aminet, for example:
  124.      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahidev.lha
  125.      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahiusr.lha
  126.      ftp://ftp.germany.aminet.org/pub/aminet/docs/misc/ahiman.lha
  127.  
  128.      WWW:
  129.      http://www.lysator.liu.se/~lcs/ahi.html
  130.  
  131. PRICE
  132.  
  133.      Free. But if you use it in a shareware of commercial product,
  134.      I would like a registered copy for me and each of the audio driver
  135.      authors (this is merely a wish, you don't have to do it if you don't
  136.      think we deserve it). See the AHI User's Guide for more information.
  137.  
  138. DISTRIBUTABILITY
  139.  
  140.      Copyright ©1994-1997 Martin Blom.
  141.      Freely distributable in unmodified form.
  142.      See the AHI User's Guide for more information.
  143.  
  144.  
  145. ============================= Archive contents =============================
  146.  
  147. Original  Packed Ratio    Date     Time    Name
  148. -------- ------- ----- --------- --------  -------------
  149.      632     274 56.6% 08-Aug-97 17:39:30  AHI.info
  150.     4922    2302 53.2% 19-Aug-97 18:34:56 +ahiusr.readme
  151.      468     231 50.6% 08-Aug-97 17:39:30 +ahiusr.readme.info
  152.      628     279 55.5% 08-Aug-97 17:39:30 +BGUI.info
  153.   123588   69860 43.4% 20-Jan-97 16:35:16 +bgui.library
  154.      362     218 39.7% 21-Mar-97 21:00:00 +Install BGUI
  155.      736     367 50.1% 21-Mar-97 21:13:56 +Install BGUI.info
  156.     3700    1420 61.6% 20-Jan-97 15:20:14 +ReadMe-BETA
  157.      468     234 50.0% 21-Mar-97 20:52:20 +ReadMe-BETA.info
  158.      364     219 39.8% 21-Mar-97 20:13:22 +Copyright
  159.      468     229 51.0% 08-Aug-97 17:39:30 +Copyright.info
  160.    18720    6968 62.7% 19-Aug-97 18:34:26 +History
  161.      468     231 50.6% 08-Aug-97 17:39:30 +History.info
  162.    75407   20185 73.2% 19-Aug-97 16:11:28 +Install AHI
  163.      709     354 50.0% 08-Aug-97 17:39:30 +Install AHI.info
  164.       34      34  0.0% 03-Jul-97 12:21:16 +User's Guide
  165.      464     226 51.2% 08-Aug-97 17:39:30 +User's Guide.info
  166.     3328    2208 33.6% 19-Aug-97 17:43:46 +AddAudioModes
  167.     1686     727 56.8% 19-Aug-97 17:48:30 +ahi.cd
  168.     1720     790 54.0% 19-Aug-97 17:48:30 +ahi.ct
  169.     2858    1104 61.3% 19-Aug-97 17:42:58 +ahiprefs.cd
  170.     2783    1157 58.4% 19-Aug-97 17:42:58 +ahiprefs.ct
  171.     1114     627 43.7% 22-Jun-97 12:40:08 +ATO.readme
  172.      708     422 40.3% 19-Aug-97 17:48:52 +ahi.catalog
  173.     1572     845 46.2% 19-Aug-97 17:43:28 +ahiprefs.catalog
  174.      726     432 40.4% 19-Aug-97 17:48:48 +ahi.catalog
  175.     1682     909 45.9% 19-Aug-97 17:43:20 +ahiprefs.catalog
  176.      778     449 42.2% 19-Aug-97 17:48:50 +ahi.catalog
  177.     1756     940 46.4% 19-Aug-97 17:43:32 +ahiprefs.catalog
  178.      750     463 38.2% 19-Aug-97 17:48:46 +ahi.catalog
  179.     1456     816 43.9% 19-Aug-97 17:43:24 +ahiprefs.catalog
  180.      740     445 39.8% 19-Aug-97 17:48:46 +ahi.catalog
  181.     1678     912 45.6% 19-Aug-97 17:43:34 +ahiprefs.catalog
  182.      686     422 38.4% 19-Aug-97 17:48:44 +ahi.catalog
  183.     1464     757 48.2% 19-Aug-97 17:43:22 +ahiprefs.catalog
  184.      706     417 40.9% 19-Aug-97 17:48:46 +ahi.catalog
  185.     1556     839 46.0% 19-Aug-97 17:43:28 +ahiprefs.catalog
  186.      776     463 40.3% 19-Aug-97 17:48:44 +ahi.catalog
  187.     1742     963 44.7% 19-Aug-97 17:43:20 +ahiprefs.catalog
  188.      804     492 38.8% 19-Aug-97 17:48:50 +ahi.catalog
  189.     1780     969 45.5% 19-Aug-97 17:43:36 +ahiprefs.catalog
  190.      734     459 37.4% 19-Aug-97 17:48:42 +ahi.catalog
  191.     1560     864 44.6% 19-Aug-97 17:43:26 +ahiprefs.catalog
  192.      812     481 40.7% 19-Aug-97 17:48:48 +ahi.catalog
  193.     1764     964 45.3% 19-Aug-97 17:43:24 +ahiprefs.catalog
  194.      732     430 41.2% 19-Aug-97 17:48:44 +ahi.catalog
  195.     1490     822 44.8% 19-Aug-97 17:43:30 +ahiprefs.catalog
  196.      888     484 45.4% 04-Jun-97 19:56:46 +Translation.ReadMe
  197.      732     455 37.8% 19-Aug-97 17:48:50 +ahi.catalog
  198.     1582     911 42.4% 19-Aug-97 17:43:32 +ahiprefs.catalog
  199.    43904   20700 52.8% 19-Aug-97 17:47:50 +ahi.device
  200.    39416   19597 50.2% 19-Aug-97 17:45:06 +ahi.device.000
  201.    43848   20656 52.8% 19-Aug-97 17:46:30 +ahi.device.060
  202.     4808    2710 43.6% 21-Jul-97 21:02:12 +delfina.audio
  203.     6376    3598 43.5% 19-Aug-97 17:35:18 +filesave.audio
  204.     6440    3634 43.5% 19-Aug-97 17:35:56 +filesave.audio.000
  205.     2040    1264 38.0% 13-Aug-97 19:43:56 +melody.audio
  206.     9376    4452 52.5% 19-Aug-97 17:36:16 +paula.audio
  207.     9480    4469 52.8% 19-Aug-97 17:36:26 +paula.audio.000
  208.     9360    4401 52.9% 13-May-97 11:02:16 +prelude.audio
  209.     6736    3371 49.9% 19-Aug-97 17:37:02 +toccata.audio
  210.     6780    3396 49.9% 19-Aug-97 17:37:32 +toccata.audio.000
  211.     3652    2065 43.4% 19-Aug-97 17:37:42 +wavetools.audio
  212.      868     205 76.3% 21-Jul-97 21:02:12 +DELFINA
  213.      580     176 69.6% 19-Aug-97 17:35:58 +FILESAVE
  214.      580     172 70.3% 12-Jun-97 19:07:24 +MELODY
  215.     2020     324 83.9% 19-Aug-97 17:36:28 +PAULA
  216.      444     150 66.2% 13-May-97 11:02:16 +PRELUDE
  217.      876     197 77.5% 19-Aug-97 17:37:34 +TOCCATA
  218.      600     171 71.5% 19-Aug-97 17:37:44 +WAVETOOLS
  219.      160     121 24.3% 27-Mar-97 12:08:50 +AUDIO
  220.      466     251 46.1% 29-Jan-97 15:56:22 +AUDIO.info
  221.     1522     876 42.4% 03-Jun-97 12:19:56 +AUDIO.MWB.info
  222.    44071   14624 66.8% 19-Aug-97 17:48:56 +ahi.guide
  223.     5568    3386 39.1% 19-Aug-97 17:38:10 +AHI-Handler
  224.      617     386 37.4% 19-Aug-97 17:43:36 +AHI.info
  225.     1849    1351 26.9% 19-Aug-97 17:43:36 +AHI.MWB.info
  226.    33044   17478 47.1% 19-Aug-97 17:42:20 +AHI_BGUI
  227.    32496   17452 46.2% 19-Aug-97 17:42:54 +AHI_MUI
  228. -------- ------- ----- --------- --------
  229.   595258  279702 53.0% 19-Aug-97 21:00:14   79 files
  230.